home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / mail300.zip / MAILMAN.DOC next >
Text File  |  1990-10-23  |  15KB  |  380 lines
  1.  
  2.  
  3.         MAILMAN: v3.00                                    by Stephen de Plater
  4.         October 23, 1990                                   GT Power Net: 302/1
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                         MAILMAN
  13.                                  by Stephen de Plater
  14.                                   GT Power Net: 302/1
  15.                                  Voice: +61 2 977-3075
  16.                                  Data: +61 2 977-2013
  17.  
  18.  
  19.  
  20.  
  21.         ======================================================================
  22.         0.                           REVISION LIST
  23.         ======================================================================
  24.  
  25.         VERSION:  Release Date:       Comments:
  26.         -------   ------------        --------------------------------------
  27.         1.00      September 9, 1988   Initial release.
  28.  
  29.         1.10      April 2, 1989       Logging  added.    Support  for  Netmail
  30.                                       level  200  added.    Support  for  full
  31.                                       pathnames   in   file  attaches   added.
  32.                                       Interactive mode added.
  33.  
  34.         2.10      June 23, 1990       Major changes!   Support for Netmail 300
  35.                                       and  GT15.xx.    ToList   added,  Remote
  36.                                       attach and Msg Attach.   Check for  file
  37.                                       exists in  all  attaches.   Port to  new
  38.                                       compiler (Turbo C++).
  39.  
  40.         2.11      July 26, 1990       Minor   Bug   fix.  Wildcards   are  now
  41.                                       accepted in files to be attached.
  42.  
  43.         3.00      October 23, 1990    GT16 *ONLY* Version.   This version will
  44.                                       NOT run  with  versions of  GT prior  to
  45.                                       GT16!   There  are no  other changes  in
  46.                                       this release.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                                      >> page 1 <<
  56.  
  57.         MAILMAN: v3.00                                    by Stephen de Plater
  58.         October 23, 1990                                   GT Power Net: 302/1
  59.  
  60.  
  61.  
  62.         ======================================================================
  63.         1.                             COPYRIGHT
  64.         ======================================================================
  65.  
  66.         MAILMAN is not placed in the Public  Domain. The copyright is retained
  67.         and the software is provided on licence:
  68.  
  69.         You are free to  use and make  as many copies of  this program as  you
  70.         wish. You may also give it away to anyone who wants it, provided:
  71.  
  72.         1.   No fee is charged.
  73.         2.   This archive is distributed intact.
  74.         3.   You register the package with an OZNET Registration Centre.
  75.  
  76.  
  77.         ======================================================================
  78.         2.                           REGISTRATION
  79.         ======================================================================
  80.  
  81.         A  new  registration   scheme  now  applies  to  all  OZNET  software.
  82.         Regardless  of any  previous registration,  this program  now requires
  83.         individual installation for each BBS using it.
  84.  
  85.         There  is  still NO  fee  involved  at all.  DO  NOT  send any  money!
  86.         Registration  simply  involves obtaining  from  me  a CRC  code  which
  87.         matches your  BBS name.   You may  do this at  any of the  seven OZNET
  88.         registration centres:
  89.  
  90.                   Kangaroo Korner          302/001   Stephen de Plater
  91.                   The Black Hole           302/003   Ken Thompson
  92.                   TSUNAMI! Catch the Wave  *TEMPDN   Chet Wilkinson
  93.                   Control Systems          071/001   Ed Cavender
  94.                   Gidget's Domain          081/005   Jack Hazel
  95.                   Fuzzy Logic              050/018   Phill Piddell
  96.                   The Gathering Place      093/000   Joe Telup
  97.  
  98.         If  you are in  the GTPN  nodelist then you  will be  able to register
  99.         direct online at any of those centres  or via mail in the correct form
  100.         to OZRobot at any of those centres.  See the included OZRobot document
  101.         for details.  If  you are not in the  GTPN net you will need  to apply
  102.         via  private netmail  or  message  to Sysop  at  any of  the  centres.
  103.         Whatever  way  you do  it  you  will need  to  supply  the full  (case
  104.         sensitive) name to which you want the program registered.
  105.  
  106.  
  107.  
  108.  
  109.                                      >> page 2 <<
  110.  
  111.         MAILMAN: v3.00                                    by Stephen de Plater
  112.         October 23, 1990                                   GT Power Net: 302/1
  113.  
  114.  
  115.  
  116.         You will  also need to obtain the  OZINSTAL program which performs the
  117.         actual installation.  OZINSTAL  is not included in this  archive.  You
  118.         should look for OZINST11.ZIP.
  119.  
  120.  
  121.         ======================================================================
  122.         3.                              PURPOSE
  123.         ======================================================================
  124.  
  125.                          (Or what does this thing do anyway?)
  126.  
  127.         MAILMAN is a companion program for GT Power BBS Systems.
  128.  
  129.         It completely  replaces the previous companion "GETFILE"  which is now
  130.         withdrawn.
  131.  
  132.  
  133.         It is designed to automate the process of standard file transfers. For
  134.         instance, if  you wish to pick  up a weekly nodelist  update from your
  135.         local hub, then simply  run this program from your netmail batch file.
  136.         On the day  of the week which you  select, it will generate  a message
  137.         containing  a file request, for  the net/node you  select, and calling
  138.         for the files you select.  Of course if you  happen to be the hub  you
  139.         can use  MAILMAN to automatically  send the file  out. In other  words
  140.         this program generates file requests and file attaches.
  141.  
  142.  
  143.         ======================================================================
  144.         4.                               USAGE
  145.         ======================================================================
  146.  
  147.         To use MAILMAN:
  148.  
  149.         1.   Install MAILMAN.EXE in your DOS path.
  150.  
  151.         2.   Include a call to it in your netmail batch file. You can also run
  152.              it  from the command line,  of course, to  generate file requests
  153.              without having even to start up your board or use an offline mail
  154.              reader.
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.                                      >> page 3 <<
  164.  
  165.         MAILMAN: v3.00                                    by Stephen de Plater
  166.         October 23, 1990                                   GT Power Net: 302/1
  167.  
  168.  
  169.  
  170.         ======================================================================
  171.         5.                             REPORTING
  172.         ======================================================================
  173.  
  174.         The screen output may, if you wish be redirected to a file if you want
  175.         to see what it did and, like me, you run it in the small hours of  the
  176.         morning when the world is asleep.
  177.  
  178.         With version 1.10  MailMan will  log all its  file attach and  request
  179.         activity.    Every time  either .FA  or .FR  is  generated, a  line is
  180.         appended to a file called MAILMAN.LOG located in the GTPATH directory.
  181.  
  182.  
  183.         ======================================================================
  184.         6.                      COMMAND LINE PARAMETERS
  185.         ======================================================================
  186.  
  187.         MAILMAN takes the following command line parameters as follows:
  188.  
  189.          1.  /N   Net/Node number to transfer  the file to/from. For instance,
  190.                   to transfer to or from 36/0 you would use the parameter like
  191.                   this: /N36/0
  192.  
  193.                   THIS PARAMETER  IS NOT OPTIONAL.   In interactive  mode ONLY
  194.                   (see  /I below) you will  be prompted for  this parameter if
  195.                   missing.
  196.  
  197.                   If  a  ToList has  been specified  (see  /T below)  then the
  198.                   net/node IDs will be taken from there instead.
  199.  
  200.          2.  /F   The  list  of  files  to be  transferred.  They  must follow
  201.                   immediately  after  the /F  with  no  white space.  Multiple
  202.                   filenames may  be separated  by any  one  of the  characters
  203.                   inside the square brackets following: [,;|]
  204.  
  205.                   For example, to transfer "file.1" and "file.2" you would use
  206.                   the following parameter: /Ffile.1,file.2
  207.  
  208.                   THIS PARAMETER  IS NOT OPTIONAL.   In interactive  mode ONLY
  209.                   (see  /I below) you will  be prompted for  this parameter if
  210.                   missing.
  211.  
  212.                   MAILMAN checks the existence  of ALL attached files.   If an
  213.                   attached file is found  to be missing, MAILMAN takes  one of
  214.                   two actions:
  215.  
  216.  
  217.                                      >> page 4 <<
  218.  
  219.         MAILMAN: v3.00                                    by Stephen de Plater
  220.         October 23, 1990                                   GT Power Net: 302/1
  221.  
  222.  
  223.  
  224.                        If you are in interactive mode, you are warned that the
  225.                        file  could not be found  and prompted again  for a new
  226.                        name.   You cannot enter  an attach for  a non existent
  227.                        file.
  228.  
  229.                        If MAILMAN is in batch mode, then the attach is aborted
  230.                        completely.
  231.  
  232.          3.  /D   The day of the week on which the file transfer will be made.
  233.                   Valid days are: MON, TUE, WED,  THU, FRI, SAT, SUN, and ALL.
  234.                   The default is ALL, in  which case the file request will  be
  235.                   issued regardless of the day.
  236.  
  237.                   This parameter  IS optional.  In interactive  mode ONLY (see
  238.                   /I  below) you  will  be  prompted  for  this  parameter  if
  239.                   missing.  An empty response to this prompt defaults to ALL.
  240.  
  241.          4.  /R   REQUEST the file(s) listed, OR
  242.  
  243.          5.  /A   ATTACH the file(s) listed, OR
  244.  
  245.          6.  /L   REMOTE ATTACH the file(s) listed, OR
  246.  
  247.          7.  /M   MESSAGE ATTACH the file(s) listed.
  248.  
  249.                   EXACTLY one of these  last four parameters MUST  be present.
  250.                   That is: you  can generate a  file request  with /R, a  file
  251.                   attach with /A, a Remote Attach with /L, or a Message Attach
  252.                   with /M. And you  must do one of them.  You may not do  more
  253.                   than one!   In interactive mode ONLY (see /I below) you will
  254.                   be prompted for this parameter if missing.
  255.  
  256.          8.  /I   Interactive  mode.  In this  mode the program  will stop and
  257.                   prompt for any missing  parameters. Filenames may be entered
  258.                   either one to  a line or  many to a  line, and the  filename
  259.                   prompt will continue until an empty line is entered.
  260.  
  261.          9.  /T   ToList mode.  In this mode a  filename MUST be specified for
  262.                   the ToList.  This file must be an ASCII  file containing the
  263.                   net/node  addresses, exactly one  per line, of  each node to
  264.                   receive this attach (or  request if you really want  to lose
  265.                   some friends!)
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                                      >> page 5 <<
  272.  
  273.         MAILMAN: v3.00                                    by Stephen de Plater
  274.         October 23, 1990                                   GT Power Net: 302/1
  275.  
  276.  
  277.  
  278.                   For  example if I  wanted to attach  MAIL210.ZIP to 302/000,
  279.                   302/003  and 093/000,  I could  create a  file  called, say,
  280.                   distrib.txt containing the following:
  281.  
  282.                        -------------------------------
  283.                        302/0
  284.                        302/3
  285.                        93/0
  286.                        -------------------------------
  287.  
  288.                   The  order is unimportant.   I could then  call MAILMAN with
  289.                   these parameters:
  290.  
  291.                        mailman /Fmail210.zip /A /Tdistrib.txt
  292.  
  293.                   The ToList file should be placed (by default) in the GTPATH,
  294.                   although a fully qualified filename will be found anywhere.
  295.  
  296.         Command line  parameters may be given  in either upper  or lower case,
  297.         and  in any order. The command line  parameter switch character may be
  298.         either "/" or "-" (i.e.: "/Dmon" is the same as "-dMON").
  299.  
  300.         The  parameters  must  not  be  run  together  (i.e.:  "/dMON   /n36/0
  301.         /fNODELIST.ARC" is fine, but "/dMON/n36/0/fNODELIST.ARC" is wrong!)
  302.  
  303.  
  304.         ======================================================================
  305.         7.                            DISCLAIMER
  306.         ======================================================================
  307.  
  308.         Q:         What kind of guarantee comes with this software?
  309.  
  310.         A:                    *** ABSOLUTELY NONE!!! ***
  311.  
  312.  
  313.         If you break it you get to keep both parts!
  314.  
  315.         I take no responsibility  at all for what this software  may do on any
  316.         computer other than my own. If you use it you do so at your  own risk.
  317.         All that I am prepared to say about it is that it works fine here (and
  318.         I can see no good  reason why it should not also  work fine everywhere
  319.         else also -- but ....)
  320.  
  321.         By using this program you accept these conditions.
  322.  
  323.  
  324.  
  325.                                      >> page 6 <<
  326.  
  327.         MAILMAN: v3.00                                    by Stephen de Plater
  328.         October 23, 1990                                   GT Power Net: 302/1
  329.  
  330.  
  331.  
  332.         ======================================================================
  333.         8.                              ENJOY!
  334.         ======================================================================
  335.  
  336.         At least, I hope you do!
  337.         Stephen
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.                                      >> page 7 <<
  380.